home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / 3dlib15.zip / 3DC.DOC < prev    next >
Text File  |  1992-10-27  |  6KB  |  153 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                              3dC DOCUMENTATION                              *
  13. * M3D macro translator to Turbo Pascal Source. V1.5                           *
  14. * Last Update : Oct. 09, 1992.                                                *
  15. *******************************************************************************
  16.  
  17.                                  INTRODUCTION
  18.                                  ------------
  19.  
  20.  
  21. 3dC is a translator that converts 3D animation macros (M3D files) into
  22. Turbo Pascal 6.0 source programs that can be used with the 3dLIB package
  23. to create 3D animation executables, or 3D animation procedures that can
  24. be implemented in your programs. From version 1.2 3dC supports compilation
  25. to Turbo Pascal for Windows source programs by using the /W+ switch on the
  26. command line. Please refer for the 3dLIB.DOC file for enhancements implemented
  27. in this version of 3dC.
  28.  
  29. M3D macro programs can be animated for test purposes using the ISoft D&M 
  30. distributed 3D120 package, Or the supplied 3dA program.
  31. You can use 3DC to create animated programs without this package. 
  32.  
  33. Please notice : older versions of the 3D program that were distributed as 
  34. 3D100 and 3D110 packages are supported, but a small change in the macro
  35. language exist in the GOTO command, that uses ',' to separate arguments, 
  36. while the older versions used only spaces, that could cause improper
  37. translation when negative arguments were passed.
  38.  
  39.                                      USAGE
  40.                                      -----
  41.  
  42. At the command line type 
  43.  
  44. 3DC input.m3d [output.pas]
  45.  
  46. Where input.m3d is the name of the input macro language.
  47.  
  48. If no output name is specified 3DC creates a pascal source file called
  49. 3DPAS.PAS .
  50.  
  51. To compile the generated source file use Turbo Pascal 6.0 with the following
  52. command :
  53.  
  54. TPC /M source.pas 
  55.  
  56. Be sure that the compiler can find the GRAPH.TPU file supplied with 
  57. Turbo Pascal.
  58.  
  59. To run the executable created type it's name in the command line, 
  60. and be sure that the required graphic .BGI file is in the current
  61. directory. (please refer to your Turbo Pascal manual about your .BGI file).
  62.  
  63. If you want 3dC to produce code for the Windows 3.0 or 3.1 environment use
  64. the /W+ switch on the command line, and compile using Turbo Pascal for Windows.
  65.  
  66. If you run Windows you can use the supplied 3dCW.EXE program - a Windows
  67. hosted generator available from version 1.4 .
  68.  
  69. More documentation regarding consideration of macro language translation is
  70. supplied for registered users of 3dLIB, in a printed manual.
  71.  
  72.                                 MACRO LANGUAGE
  73.                                 --------------
  74.  
  75. The following commands are supported by the 3DC translator in the 3D Macro 
  76. language :
  77.  
  78. c   - Clear Screen .
  79. w   - set Color to White.
  80. b   - set Color to Black.
  81. p   - Paint Active object in last color.
  82. o0  - set Perspective off.
  83. o1  - set Perspective on.
  84. >x   - Start a loop to be performed x times.
  85. lfl - Load simple object from file fl into the active object.
  86. Lfl - Load complex object from file fl into the active object.
  87. rad  - Rotate Active Element In axis a, d degrees.
  88. ex  - Choose Active Element x.
  89. mas  - Move in a axis, s steps.
  90. gx,y,z - Goto 3d pos x,y,z.
  91. saf  - Scale a axis in f factor.
  92. v0..v9 variable names.
  93. <    - End Loop.
  94. \    - End line.
  95. z    - set object to center.
  96. Rsad - rotate a sub object of a complex object
  97.         around axis a, d degrees.
  98. Msas - move a sub object of a complex object
  99.         in axis a, s steps.
  100. Ssaf - scale a sub object of a complex object
  101.         around axis a, by a factor of f.
  102.  
  103.  
  104.  
  105. Special Notes : a number must end with a space character.
  106.                 Loops can be nested 10 levels deep in the 3D111 package, 
  107.                 but 3DC can translate even more levels that.
  108.  
  109.                 any numeric expressions requested can be
  110.                 given with a normal infix notation, for
  111.                 example :
  112.  
  113.                 rx30 * v1 + 2
  114.  
  115.                 will rotate the current active object
  116.                 around the x axis, by 2 plus 30 * v1
  117.                 degrees, where v1 is a variable.
  118.  
  119.                                     General
  120.                                     -------
  121.  
  122.   3dLIB is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  123.   
  124.   3dLIB is (c) copyrighted by Loewy Ron, 1991, 92.
  125.  
  126.   3dLIB is a shareware package, please register your copy. 
  127.   To register your copy of 3dLIB please refer to the supplied
  128.   3DLIB.REG file. 
  129.  
  130.   Other programs distributed by ISoft D&M are described in the supplied  
  131.   PROGRAMS.TXT file.
  132.  
  133.                                     Contact
  134.                                     -------
  135.  
  136.   Please contact :
  137.  
  138.   ISoft D&M,  
  139.   P.O.B 5517
  140.   Coralville IA 52241,
  141.   U.S.A
  142.  
  143.                                     Credits
  144.                                     -------
  145.  
  146.   3dLIB and 3dC were written using Turbo-Pascal V6.0, a copyright of 
  147.   Borland International.
  148.  
  149.   Turbo Pascal and Turbo Pascal for Windows are copyrights of 
  150.   Borland International.
  151.  
  152.   Windows 3.0 and Windows 3.1 are copyrights of Microsoft Corp.
  153.